/* Interface for the Object class for Objective-C.
   Copyright (C) 1993, 1994, 1995, 2009, 2010 Free Software Foundation, Inc.

This file is part of GCC.

GCC is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 3, or (at your option) any
later version.

GCC is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
License for more details.

Under Section 7 of GPL version 3, you are granted additional
permissions described in the GCC Runtime Library Exception, version
3.1, as published by the Free Software Foundation.

You should have received a copy of the GNU General Public License and
a copy of the GCC Runtime Library Exception along with this program;
see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
<http://www.gnu.org/licenses/>.  */


#ifndef DOBJECT_H
#define DOBJECT_H

#include <stdarg.h>

#include <objc/objc.h>
#include <objc/Object.h>


/* The Object class is a minimal (but fully functional) root class
   included with the runtime.

   It is mostly for testing the runtime; very handy in configure
   tests, and when writing language/runtime testcases.

   Because Objective-C allows multiple root classes, a Foundation
   library (such as GNUstep-base) is expected to provide its own root
   class (typically called NSObject), fully integrated with the
   library's own high-level features.  If you are using such a
   Foundation library, you should most likely use its root class for
   everything and ignore Object.
*/

/*
  All classes are derived from Object.  As such,
  this is the overhead tacked onto those objects.
 */
@interface DObject : Object
{
}

        /* Initializing classes and instances */
+ (id) initialize;
- (id) init;

        /* Creating, freeing, and copying instances */
+ (id) new;
+ (id) alloc;
- (id) free;
- (id) copy;
- (id) shallowCopy;
- (id) deepen;
- (id) deepCopy;

        /* Identifying classes */
- (Class)class;
+ (Class)class;
- (Class)superClass;
+ (Class)superClass;
- (Class)metaClass;
- (const char *)name;
+ (const char *)name;

        /* Identifying and comparing objects */
- (id) self;
- (unsigned int)hash;
- (BOOL)isEqual:anObject;
- (int)compare:(id)anotherObject;

        /* Testing object type */
- (BOOL)isMetaClass;
- (BOOL)isClass;
+ (BOOL)isClass;
- (BOOL)isInstance;

        /* Testing inheritance relationships */
- (BOOL)isKindOf:(Class)aClassObject;
- (BOOL)isMemberOf:(Class)aClassObject;
- (BOOL)isKindOfClassNamed:(const char *)aClassName;
- (BOOL)isMemberOfClassNamed:(const char *)aClassName;

        /* Testing class functionality */
+ (BOOL)instancesRespondTo:(SEL)aSel;
- (BOOL)respondsTo:(SEL)aSel;

	/* Testing protocol conformance */
+ (BOOL)conformsTo:(Protocol*)aProtocol;
- (BOOL)conformsTo:(Protocol*)aProtocol;

        /* Introspection */
+ (IMP)instanceMethodFor:(SEL)aSel;
- (IMP)methodFor:(SEL)aSel;
+ (struct objc_method_description *)descriptionForInstanceMethod:(SEL)aSel;
- (struct objc_method_description *)descriptionForMethod:(SEL)aSel;

        /* Sending messages determined at run time */
- (id) perform:(SEL)aSel;
- (id) perform:(SEL)aSel with:anObject;
- (id) perform:(SEL)aSel with:anObject1 with:anObject2;

        /* Forwarding */
#if 0
- (id)forward:(SEL)aSel : ...;
- (id)performv:(SEL)aSel : ...;

        /* Posing */
+ (id) poseAs:(Class)aClassObject;
- (Class)transmuteClassTo:(Class)aClassObject;
#endif

        /* Enforcing intentions */
- (id) subclassResponsibility:(SEL)aSel;
- (id) notImplemented:(SEL)aSel;
- (id) shouldNotImplement:(SEL)aSel;

        /* Error handling */
- (id) doesNotRecognize:(SEL)aSel;
- (id) error:(const char *)aString, ...;

        /* Archiving */
+ (int)version;
+ (id) setVersion:(int)aVersion;

@end

#endif
